home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / commodity / blocnotes3.1.lha / BlocNotes / BlocNotes.doc < prev    next >
Encoding:
Text File  |  1995-01-21  |  11.2 KB  |  266 lines
  1.    BlocNotes v3.1
  2.    Shareware $10 fee
  3.    © 1994 Roberto Ferorelli
  4.  
  5.    e-mail: mc2068@mclink.it
  6. -----------------------------------------------
  7.  
  8. DESCRIPTION
  9.    BlocNotes  it's  a  WB  commodity that permits to take some notes.
  10.    When  you  hit  a custom hotkey it opens a window:  in that window
  11.    you  can  insert  as  much text as you want.  All the text will be
  12.    stored,  together with a description of the window, in a file, so,
  13.    at  startup, all  the  previously opened windows will be reopened,
  14.    each one with its text.
  15.  
  16.    It's  possible to open a great number of windows(in theory there's
  17.    no  limit  but Intuition can't look at too much windows together).
  18.    For  each  window  you can set the textfont, the size and position
  19.    and some other stuffs(as GADGETLESS or EDITABLE).  You can set for
  20.    each thing a default value.
  21.  
  22.    It supports completely  the clipboard, so you can copy text from a
  23.    shell  to  a  note-window  or  viceversa.   You can also import or
  24.    export files.  All the windows can be closed or completely deleted
  25.    with a simple command.
  26.  
  27.    Every  window has simple editing functions, word wrapping and text
  28.    scrolling, so  it's not necessary to  size  the window at its  max
  29.    dimensions. You can import text automatically  dropping an icon in
  30.    one of the windows.
  31.  
  32.    If you want you can fix a window to a particular public screen, so
  33.    when that public screen is opened, the notewindow appears and when
  34.    the screen is closed the notewindow disappears.
  35.    It is also possible to specify a standard screen where the windows
  36.    will be opened.
  37.  
  38. INSTALLATION
  39.    The program must be copied to the  WBStartup  drawer for best use.
  40.    It needs a directory where store all  the notes to. You can supply
  41.    the  name  of this  dir specifing  it  in  the tooltype  DIRECTORY
  42.    or simply starting the  first time  the  program: it will appear a
  43.    FileRequester and  then the name will be stored in the tooltype.
  44.    You can set the hotkey to open a note-window through  the tooltype
  45.    NOTEKEY. The default is: NOTEKEY=<CONTROL ESC>.
  46.  
  47.    If you  insert the program in  the WBStartup  drawer  and want  to
  48.    avoid the disk noises that Blocnotes produces when it searches its
  49.    files while the Workbench is still loading some other program, you
  50.    can  use the tooltype  DELAY  followed by the number of seconds BN
  51.    must wait before accessing the disk: (i.e. DELAY=5 for a 5 seconds
  52.    wait).
  53.  
  54. USE
  55.    To  open  a  window  you must hit the hotkey (NOTEKEY), the window
  56.    will  be  opened in a standard position; you can then insert text,
  57.    change the position  or  the  size  of the  window(through gadgets
  58.    or with CONTROL or ALT keys together with mouse button), set a new
  59.    font(through menu), enable or disable Insert-mode(<Ins> key on the
  60.    numeric pad), make the window editable or not, make it gadgetless,
  61.    and even enable or disable the scroll bars.
  62.    Every  window  has  a  menu  bar  and  supports the clipboard with
  63.    standard keys:
  64.       <AMIGA+B> toggles <Mark Block Mode>.
  65.       <AMIGA+V> inserts text from the clipboard.
  66.       <AMIGA+C> copies text to the clipboard.
  67.       <AMIGA+X> deletes text and inserts that in the clipboard.
  68.    and also:
  69.       <AMIGA+K> deletes line.
  70.       <AMIGA+L> undeletes line.
  71.    Each  change  will  be  stored in a file in the choosen directory.
  72.    With the Import command you can load an external file in the note,
  73.    with the Export one you can save the note in a file.
  74.    The  second  hotkey(defined with CX_POPKEY and <CONTROL ALT n> for
  75.    default)  opens  the  interface  window  where you can set all the
  76.    default settings for the new windows.
  77.  
  78.    From  the  2.0  version  it's  possible to make the program open a
  79.    window  and  import a text automatically.  The file of text can be
  80.    in  the  directory  choosen at startup, or can be inserted in this
  81.    dir  at  any  time.  Blocnotes uses Notify system to hear of a new
  82.    file  in  this  directory and then load it.
  83.    A possible use it's to "leave out" the icon of the notes-directory
  84.    so  leaving  an  icon  of  a  text file above this one will open a
  85.    window and  import the text. The original  text files will be left
  86.    untouched  or will  be  deleted  depending  from  the  DELETEFILES
  87.    switch.
  88.  
  89.    Another way to import a file in a note-window (it's  possible only
  90.    if  the window is on the WB Screen) is simply to drag  the icon of
  91.    the file in the note-window. Every window is a WB AppWindow.
  92.  
  93.    Every  notewindow can be moved in the screen even if it hasn't the
  94.    dragbar(if GADGETLESS), you must simply press the CONTROL key  and
  95.    then,with it pressed,press the left mouse button inside the window
  96.    and move the pointer. In a similar way it is  possible to size the
  97.    window without using the sizing gadget, the key for sizing is ALT.
  98.  
  99.    The background  of the windows is yellow, but if you want a normal
  100.    backcolor you can disable that, specifing tooltype: YELLOWBACK=NO.
  101.    With WB3.0 it uses pen sharing to obtain a light yellow.With older
  102.    versions it searches in the  colormaps of screens for  the closest
  103.    color to yellow and uses it. So with AmigaOS before version 3.0 is
  104.    suggested to set through WBPalette prefs a yellow color for WB.
  105.  
  106.    If you want to fix a note to the public screen where the window of
  107.    the note is, you have to select the menu item <Fixed Screen>.
  108.    The window will always be  opened on that Pubscreen, if it exists,
  109.    or  will wait for the screen  to be opened. If you  set in the GUI
  110.    the <fixed screen> gadget all the new windows will be fixed.
  111.  
  112.    You  can  also specify a screen,  where all the  new notes and the
  113.    notes not fixed will be opened, with the SCREEN tooltypes:
  114.     "SCREEN=default" for windows opened on default public screen.
  115.     "SCREEN=<Public screen name>" for windows opened on specified
  116.                                   pubscreen.
  117.  
  118.    A window can be  opened automatically at  startup or can be always
  119.    hided. So it's possible to use BlocNotes as a real block of notes.
  120.    Open a window, insert your data, make the window not AutoOpen  and
  121.    then hide it. The note will be accessible simply using the BN gui.
  122.  
  123.    *****************************************************
  124.    *****************LIST OF TOOLTYPES*******************
  125.    *****************************************************
  126. CXPOKEY=<hotkey>
  127.    Hotkey for user interface. (<CONTROL ALT n> is default)
  128.  
  129. NOTESKEY=<hotkey>
  130.    Hotkey to open a new note. (<CONTROL ESC> is default)
  131.  
  132. DIRECTORY=<path>
  133.    The directory where the notes will be saved.
  134.    ("NOTES:" is default)
  135.  
  136. DEFFONTNAME=<fontname>
  137. DEFFONTSIZE<fontsize>
  138.    The name and the size of the default font.
  139.  
  140. YELLOWBACK=<YES or NO>
  141.    If actived, the background of the windows will be yellow.
  142.  
  143. DELETEFILES=<YES or NO>
  144.    If enabled, when you put a file in the Notes directory
  145.    the file is loaded and then deleted(at next startup).
  146.  
  147. DELAY=<seconds>
  148.    Number of seconds to wait before loading notes.
  149.  
  150. SCREEN=<screenname>
  151.    The name of publicscreen where the windows will be opened or
  152.    default for default public screen. If omitted->default.
  153.  
  154.    The next are for new windows opened:
  155.  
  156. FIXEDSCREEN=<YES or NO>
  157.    If YES, the new windows will be fixed to their screen.
  158.  
  159. INSERT=<YES or NO>
  160.    Insert mode enabled or disabled on new notes.
  161.  
  162. GADGETLESS=<YES or NO>
  163.    New windows will have gadget or no?
  164.    YES means "no gadget", NO means "with gadget".
  165.  
  166. WORDWRAP=<YES or NO>
  167.    Enable or disable Wordwrap.
  168.  
  169. SCROLLER=<YES or NO>
  170.    Enable or disable scrollbars.
  171.  
  172.    *****************************************************
  173.    **********************HISTORY************************
  174.    *****************************************************
  175.  
  176. Version 1.5:  5-6-94
  177.     First Public Release, rewritten from scratch (the old version
  178.     used simply a CON: window and had no other features).
  179.  
  180. Changes in version 1.7:
  181.  -> Fixed some bugs.
  182.  
  183. Changes in version 2.0:             3-10-94
  184.  -> Better selection of blocks, Now it works like the system shell.
  185.  -> Makes use of the locale system. Language supported are english and
  186.     italian(at the moment!).
  187.  -> General cleanup and fixing of minor bugs.
  188.  -> Imports automatically an extern file at startup.
  189.  -> Opens a window and imports a file exactly at the moment the file
  190.     is copied to the directory choosen(NOTIFY).
  191.  -> Every future enhancements will be more simple and files will be
  192.     always compatible with older ones.
  193.  
  194. Changes in version 2.1:
  195.  -> With wb 3.0 or  greater the backs of the  windows are yellow, to
  196.     make the windows more in evidence. You can turn off this option
  197.     with the tooltype YELLOWBACK=<YES or NO>.
  198.  -> If you press the left mouse button in a noteWindow while pressing
  199.     the CONTROL key, you can move the window in the screen. It's so
  200.     simplier to use GADGETLESS windows.
  201.  -> Added the DELETEFILES tooltype.Normally if you save a file to the
  202.     notes directory it's loaded in a notewindow and the original file
  203.     is left untouched; with this option active the original file will
  204.     be deleted. (DELETEFILES=<YES or NO>) Default is: not active.
  205.  -> Added the DELAY tooltype to avoid disk noise at startup.
  206.  
  207.  Changes in version 2.2:
  208.  -> Completely rewritten the editing routine. Now act in a way more
  209.     similar to a normal text editor.
  210.  -> Added the delete line function and the undelete line.
  211.  -> Better support of locale with use of national specific chars.
  212.     Removed RLE routine that hit with ASCII-extended chars. Automatic
  213.     conversion routine created.
  214.  -> With DELETEFILES active, BN didn't delete the .info file together
  215.     with the text file, fixed.
  216.  
  217.  Changes in version 2.5:
  218.  -> Added text scroll. Now the cursor is always visible; the text
  219.     scrolls to follow it.
  220.  -> Added scroller gadget to allow viewing of an entire note using
  221.     mouse.
  222.  -> FIXED a probably dangerous bug: when a note was not editable some
  223.     editing function could take to a deadlock.
  224.  -> Added SCROLLER tooltypes to enable or disable window scrollers.
  225.  -> Rewritten CONTROL-dragging routine and added ALT-sizing.
  226.  -> Fixed a problem that showed during passage of text from a window
  227.     to another window through clipboard.
  228.  
  229.  Changes in version 3.0:         14-11-94
  230.  -> Added screen attached windows.
  231.  -> Added FIXEDSCREEN Tooltype.
  232.  -> Added Listview to interface window.
  233.  -> Changed <Hide/Show All> to <Enable/Disable>
  234.  -> Enable(or disable) from Exchange now shows(or hides) all windows.
  235.  -> Yellow background extended to all OS. It searches in the colormap
  236.     of screen the closest color to yellow and uses it.
  237.  -> Added SCREEN Tooltype and gadget.
  238.  -> Added wordwrap mode and tooltype WORDWRAP.
  239.  -> Fixed enforcer hits.
  240.  -> Added AppWindows feature.
  241.  
  242.  Changes in version 3.1:        19-12-94
  243.  -> Added AutoOpen switch. Window can be hided from startup.
  244.  -> Fixed bug in Clipboard functions.
  245.  -> When a window was not editable, selecting the mark block
  246.     function take to a deadlock: fixed.
  247.  
  248. I think/hope that this one should be the last version!!
  249. (I didn't study to complete this version.....
  250. ......not so bad, after all!! ;-)
  251.  
  252. If you like this program, let me know and...consider registering it!
  253.  
  254. ---------------------------------------------------------------------
  255. If you had any request or want to report a bug or want to register to BN
  256. you can contact me through:
  257.  
  258. e-mail: mc2068@mclink.it
  259.  
  260. or simple mail:
  261.  
  262. Roberto Ferorelli
  263. Via Amendola 201/9
  264. 70126 BARI
  265. (ITALIA)
  266.